AnnSetRotateOptions method (ILEADRasterAnnotation)

Visual Basic example

Visual C++ 5.0 example

 

Syntax

short AnnSetRotateOptions(long hObject, VARIANT_BOOL bShowRotateHandles, long lReserved, long lFlags, VARIANT_BOOL bSelected);

Overview

Refer to Implementing Annotations.

Remarks

(Document/Medical only) Sets the rotation options for the annotation object.

This function is one of the new functions being introduced as part of Version 14.5. Use this method to set the rotate options of any annotation object, including the automation object.

With the new rotate options, two rotate handles are displayed on a selected object. One of the handles is the "gripper" handle, which rotates the object when dragged. The other handle is the "center" handle, which determines the center of rotation. The center of rotation can be moved by dragging. The gripper handle can be moved anywhere by dragging.

The following figure illustrates a rotate by dragging the "gripper" handle:

image\gripper.gif

The following figure illustrates moving the "center" handle:

image\centerhandle.gif

The rotate handles can be reset to a default location by right-clicking the annotation object, and selecting the Reset Rotate Handles option, as shown in the following figure:

image\resetrotatehandles.gif

The rotate handles can be globally hidden or displayed by right-clicking on the image (not an annotation object), and selecting the Hide Rotate Handles For All Objects option, as shown in the following figure:

image\hiderotatehandles.gif

Note:

In Version 14.5, you need to first enable this function by calling the AnnSetOptions method with the ANN_OPTIONS_NEW_ROTATE flag set. For more information, refer to New Annotation Features of Version 14.5.

If the value of the AnnContainer property is passed as the hObject parameter, the method will modify all the annotations in the container depending on the value of bSelected parameter.

If the value of the AnnAutomation property is passed as the hObject parameter, the method will modify the default values used whenever an annotation is created.

See Also

Elements:

AnnGetRotateOptions method, AnnShowRotateHandles property

Topics:

Annotations (Document/Medical only): Object Manipulation

 

New Annotation Features of Version 14.5